# 第 15 章 复用路线：视频课、认证课与图书的切法

这一章面向一个特定读者：要把 WorkBuddy 讲给别人听的人——录课的讲师、做企业内训的负责人、写教程的作者。本书的产出本身是一套可拆用的教学资产，这章给出拆法：哪些章撑起一节视频课，哪些模块构成一个认证单元，实操环节怎么设计才不翻车。

如果你不讲课，本章可以跳过，不影响全书的完整性。

## 15.1 一节课的骨架：90 分钟讲透 Harness

以「WorkBuddy 的 Harness 设计」为主题的完整一讲（约 90 分钟），从本书取材的推荐切法：

**开场 10 分钟**——用第 1 章的开场：一次真实对话的五环拆解。观众对着自己每天在用的产品，看到「按下回车后发生了什么」，好奇心就位。配上第 1 章的全景图作为第一张幻灯片。

**概念 15 分钟**——第 2 章的五层模型。给观众一个能装下所有后续内容的框架。Red Hat 那句「Sandbox constrains，Harness enables」适合做这节的收束金句。

**机制纵深 35 分钟**——这是主体，三个模块按需选：提示词拼装（第 5 章，现场演示打开模板目录，观众第一次看到「UI 背后的文件」时的冲击力最强）、专家解剖（第 7 章，现场选一位专家对话，再打开它的 plugin.json 对照 UI 字段）、记忆三层（第 4 章，现场 cat 自己的 MEMORY.md）。每个模块的讲法都是同一个范式：**可见行为 → 打开文件 → 对照映射 → 架构判断**。这个范式本身就是本书可传授的方法。

**风险与治理 15 分钟**——第 12 章的浓缩：注入面、明文凭证、权限三层、七条自查。企业学员这段最关心，放在后面恰好承接他们已经建立的机制理解。

**收尾 15 分钟**——第 14 章的五步排查法 + 现场答疑。给观众一个「明天就能用」的带走件。

## 15.2 认证单元：智能体工程师课程的嵌入方案

面向工程师的认证课程（如智能体工程师认证），本书内容可以组成一个 4—8 学时的模块，设计要点：

**考核目标对齐三个层次**：能解释（机制层：五层模型、拼装机制、三层记忆——笔试/口试）、能操作（实操层：五步排查、技能开发、插件评估——上机考核）、能设计（架构层：为组织设计规则+技能+插件的分发方案——方案答辩）。本书第 14 章的模式三（团队规范三层分发）可以直接做答辩题干。

**实操环节的防翻车设计**：所有上机任务用可逆环境（临时目录、只读命令、备份先行——第 14 章的所有命令都按这个标准写过，直接复用）；考核用的 WorkBuddy 环境提前冻结版本（本书方法：版本号 + 文件指纹，附录 D）；准备离线降级方案（网络或服务异常时，用会话样本文件做「考古式」实操——第 10 章的 JSONL 分析不需要活的应用）。

**与课程其他模块的衔接**：本书模块适合放在「提示词工程」之后、「多 Agent 编排」之前——它恰好是从提示词到系统之间的那层。前接的知识（上下文、指令遵循）在本册第 4、5 章深化；后接的话题（编排、协作）在第 7 章专家团处开了头。

## 15.3 图书写作的复用边界

如果你在写一本 WorkBuddy 的入门书或使用手册，本书的复用要守两条边界。

其一，**机制内容引用要带版本锚点**。本书全部机制描述绑定 5.3.13 与文件指纹，你的书引用时保留这个锚（「据某某版本实测」），否则你的读者会在更新日志的速度里迷失。其二，**实操内容请重写而非照搬**。本书的命令与流程在声明环境验证过，但教学设计（步骤密度、提示语、练习梯度）应该按你的读者重新校准——直接搬命令可以，直接搬章节不行，机制分析的表述也建议重述（事实不受版权保护，表达受）。

反过来，本书从你的教学中能获得的东西也值得说：课堂上是机制被证伪的最佳环境——学员机器上的「不生效」案例，每一个都是五步排查法的实弹演习，也是下一版更新的素材来源。

## 15.4 教学资产清单

本书可直接转为教学资产的清单，供备课速查：

| 资产 | 位置 | 教学用途 |
|-|-|-|
| 五环全景图 | 第 1 章 | 开场框架 |
| 五层模型对照表 | 第 2 章 | 概念骨架、板书结构 |
| 目录六家族表 | 第 3 章 | 上机导航图 |
| 三层记忆矩阵 | 第 4 章 | 记忆模块主图 |
| 拼装数据流图 | 第 5 章 | 机制主体演示 |
| 专家四件套与 UI 映射 | 第 7 章 | 现场对照演示 |
| 供应链三问 | 第 8 章 | 安全讨论引导 |
| 五步排查法 | 第 14 章 | 收尾带走件、考核大纲 |

一条备课时的重要提醒：演示环境提前一天做全量验证（你的机器、你的版本、你的插件组合），并准备会话样本文件做备份演示——现场网络的不可控，教过课的都懂。

## 15.5 全书收束

回到开头的问题：为什么一个把按钮做到极简的产品，值得一本讲底层文件的书？因为按钮解决的是「能不能用」，理解解决的是「能不能用好、敢不敢托付」。WorkBuddy 把 Harness 的全部复杂性装进了 `~/.workbuddy` 这个安静的目录，这本书做的只是把它打开给你看。

机制会过时——这个产品两天一个版本，书里的文件路径和字段名终将变成考古材料。但方法不会：五层模型是分析任何 Agent 的框架，「UI → 文件 → 请求」是追问任何黑盒产品的路径，证据意识（会话、轨迹、审计）是与技术共处的底气。带着这三样，下一个现象级 Agent 出现时，你打开它的数据目录，就知道该看什么。

大鹏主编｜智见 AI 出品